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1. INTRODUCTION 
1.1 Features 


This article describes the IP Various functions and usage methods of Compiler ( IPC for short ). IP 
Compiler is an IP module generator in the FPGA toolkit. This generator is parameterized and various 
parameters can be set by the user. 


Users of IPC need to understand the concepts of the IP model and its instantiation. IP model ( IP 
model ) is a parameterized template describing an IP behavior provided by FPGA manufacturers or 
third-party IP manufacturers, IP instance ( IP instance ) is the result of the user applying a set of specific 
parameters to an IP model. IPC contains some preset IP models and can manage each IP instance. 


1.2 Start IPC 


IPC can be started separately or opened from Pango Design Suite by clicking the menu item 


Tools IP Compiler or directly clicking the IP Compiler button in the toolbar. 
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2. MASTER WINDOW 


The main interface of IPC includes main control window and configuration window. This chapter 
mainly describes the main control window (see the figure below). 
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Figure 2-1 Main control window 


The IPC main control window is an interface for managing and using IP models and their 


instances. It is mainly composed of navigation area, work area and information area. The following will 
describe each part and function in detail. 
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2.1 Navigation area 


The navigation area is usually located on the left side of the main control window, and can be 
opened or hidden through the menu item View -> Navigator. There are two pages in the navigation 
area, which can display IP models and IP instances respectively. Click the menu item View Refresh or 
the toolbar button C to refresh all IPs. 


2.1.1 Browse IP Models 


The IPC will automatically load the IP model after startup. IP models are usually saved in the ip 
subdirectory under the installation path. 


Select the Catalog page to display all loaded IP models. When browsing, you can choose to sort by 
function or name in two viewing modes. When View by Function is selected, the navigation area is 
displayed as a tree structure composed of categories (see the left figure below), in which the icon 
Represents a (sub)category (these categories are defined by the IP vendor), #Ё represents an IP 
model, Ф Indicates an IP model that requires a license ; when View by Name is selected, the navigation 
area is displayed as a table structure (see the figure on the right below), which can be sorted by name, 
version, etc. In both modes, an IP model can be selected, and its content will be filled in the working 
area on the right. 


The two display modes are interchangeable. In the View by Function mode, click the right mouse 
button and the View by Name menu item will appear; when in the View by Name mode, click the right 
mouse button and the View by Function menu item will appear. 


The IP in View by Function mode is displayed as shown below: 
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The IP display in View Бу Name mode is as follows: 


te (38) 

$ Accumaletor (1.1) 

В озон (1-3) 

ЖФ Ctocribated TIFO 1.2 

$ Distributed ки (1.2) 

@ Dieceibured Shift Register (1.2) 

$ Distrituied Simple Dual Fort ВАМ (1.21 
$ вле Single Port RAM 41.2) 

В сен Bered Dual Porc РАК (1.2) 

@ гах Seres ITO (2.2) 

@ сен Based ROM (1.1) 

8 ск Daves Simple Duel Fors RAM (1.2) 
ФВ ган Based Single Port BAM (1.1) 

$ лоз ть o. 

$ muitiupiyAeeumelater (1.1) 

@ Mulciply-Adder (1.2) 
СЕЕ 
@ ан 


$ šizpie woitipiier (1.1 


Figure 2-2 Browse IP models 
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Preview 
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Collapse A11 
Expand A11 


View by Name 


Export to HIML... 


Figure 2-3 The shortcut menu of the Catalog page 
o [ Preview ] : Preview the configuration status of the selected IP model. 


o [ View Datasheet ] : View the data sheet document of the selected IP model. Equivalent to 
menu item Project View Datasheet or toolbar button ЕЈ 


o [ Properties 1 : View the basic properties, supported devices and supported PDS versions of 
the selected IP model, and a dialog box will pop up after clicking (see the figure below). 


E IP Properties - Generic х 
$} DRM Based ROM (1.3) 


== swrortea Devices Compatible Tool Versions 


Наше DRM Based ROM 
Version 1.3 

ID 04100204 

Vendor 
| Category Module-»Mezory-»DRM 


Path В: \ trunk \trunk\ip\podule_ip\ipmzl flex ramiipm21 flex кам 


Close 
Figure 2-4 Basic properties of the IP model 
o [ View by Name ] Sort by name to view. 


o [ Collapse All ] : In the View by Function mode, collapse all the expanded tree subitems. 


o 


[ Expand All 1 : Expand all tree subitems in View by Function mode. 


o 


[ Export to HTML... ] Export IP to html file, you can choose to export all IP or the IP supported 
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by the current device. 
2.1.2 Browse IP instances 


IPC starts, it will automatically load the last opened IP instance, or all IP instances under the 
specified project path. However, users can still manually import existing IP instances: to import a single 
IP instance, click the menu item Project Import Instance or the toolbar button $, a Не selection 
dialog box will pop up to select an index file of an IP instance or a project file of a PDS ; to search and 
import multiple IP instances, click the menu item Project Search and Import Instances or the toolbar 
button га, апа а path selection dialog box will pop up to select a path. After confirmation, it can 
automatically search and import IP instances in it and all subdirectories under it. 


Select the Project page to display all loaded IP instances. The navigation area is displayed as a table 
structure (see image below), which can be sorted by name, version, last build time, etc. 


^ 


Nane Description Time Path 


5) а fifo.v 2019-12-16 16:59 р:\ү‹ 
E) а fifo tmpl.v Instantiation Template 2019-12-16 16:59 D:Vyt 
2) a fifo tupl.vhdl Instantiation Template 2019-12-16 16:59 D:\y« 
=) generate. log Generate Log 2019-12-16 16:59 р:\у‹ 
=) ipm distributed fifo ctr vl 0.v 2019-06-26 05:29 D:Wyt 
E) ipm distributed fifo vl 2 а fifo.v 2019-12-16 16:59 D:\ye 
=) ipm distributed sdpram vl 2 a fifo.v 2019-12-16 16:59 р: \у‹ 


Figure 2-5 Browse IP instance 


An IP instance can be selected, and the content in the working area of the main control window 
will change accordingly. Click the right mouse button on the page to pop up a shortcut menu (see the 
figure below). 
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Close Files 


Properties 
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Figure 2-6 The shortcut menu of the Project page 


o [Customize 1 : Open the configuration window to set parameters for the selected IP instance, 


or you can directly double-click an IP instance item to perform the same operation. Equivalent to menu 
item Project Customize or toolbar button » 


o [ Regenerate ]: Regenerate the selected IP instance according to the current parameter setting. 
Equivalent to the menu item Project Regenerate or the toolbar button in the Customize interface Al 


o | Regenerate All 1 : Regenerate all IP instances in the list according to the current parameter 
settings. Equivalent to menu item Project>Regenerate All. 


o [ Copy 1 : Copy the IP, set the instance name and path of the IP and choose to add it to the 
project. 


o [ Remove ] :Delete the selected IP instance, this is a multi-functional check box, and you can 


choose whether to completely clear it from the disk (see the figure below). Equivalent to menu item 
Project->Remove Instance or toolbar button x. 
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Figure 2-7 Deleting an IP instance 


o [ View Datasheet ] : View the data sheet of the selected IP model, usually a document in PDF 
format. Equivalent to menu item Project View Datasheet or toolbar button B]. 


o [OpenFolder] :Openthefolder where the IP instance is located in the resource manager that 
comes with the system. 


o | Close Files ] : Close all the opened files under this instance. 
o [ Collapse All 1 : Collapse all expanded tree items. 


o [ Properties ] : View the basic properties of the selected IP instance, and a dialog box will pop 
up (see the figure below). 
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Figure 2-8 Basic attributes of an IP instance 


2.1.3 Filter IP Model 


2. Master window 


After IPC is started, you can use the filter button in the lower left corner of the navigation area to 
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Figure 2-9 Filter interface 


2. Master window 


Ready — > 


o [Current ] : Display the IP model supported by the current PDS engineering device; 


o [Specified ] : You can filter the supported IP models according to the device; 


o [ Any 1 : support all IP models; 


o [ Include IP which is not installed ] : Display the IP model that is not installed but in the iplist.xml 


file; 


o [IncludelP which is not compatible 1 : Display incompatible IP models, such as the IP that does 
not support the current PDS version. 
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2.2 Work area 


IP model or instance is selected in the navigation area, its corresponding content will be displayed 
in the working area. There are two pages in the working area, which can configure an IP instance and 
display the information of the IP model. The main function of the work area is to start configuring an 
IP instance on the Configuration page (see the figure below). 


Pathname р: \add\ipeore\ LSOH\ fifo. 18 Browse... 
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Version 1.2 
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Speed Grade 


Figure 2-10 The working area of the main control window 


o [Pathname ] : Specifies the full path name of the data file of an IP instance. The file name is 
usually suffixed with.idf for easy identification. IP instances are usually placed in a separate directory. 
Click the Browse button to freely select a file path; click Proj Path to fill in the recommended path in 
the PDS project; you can also manually enter the path. Only the characters AZ, az, 0-9, underscore ( ), 
minus sign (-), period (.), space, and @ are allowed in the path name. 


o [Instance Name 1 : Enter the name of the IP instance, which must comply with the restrictions 
on the module name in the Verilog syntax, and does not conflict with the reserved name set in the 
Preferences dialog box, otherwise there will be an error warning and the configuration operation 
cannot continue. After clicking the Browse or Proj Path button to set the content of Pathname, the 
path name can be automatically completed when entering the name; if the content of Pathname is 
manually modified, the automatic completion will be temporarily stopped. Only the characters AZ, az, 
0-9, and underscore ( ) are allowed in the name. 


o [ IP ] : This area displays information such as the name, version and publisher of the selected 
IP model 


o [Рам 1 : In this area, you can select the family, model, package type and speed grade of the 
FPGA device; click the Reset button to restore to the default device settings. 


о After entering the corresponding information above, click the Customize button to start the 
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configuration work: generate space for the IP instance on the disk, and open the configuration window 
to set various parameters of the IP in detail. 


o [ Symbol ] : This area displays the input and output ports of the selected IP instance (when 
creating a new IP instance, it will automatically select the new IP instance and display its port). 


Click on the Information page to view introductory information about the current IP in HTML 
format. 


2.3 Information area 


It be opened or hidden through the menu item View->Message or the Message option in the right- 
click menu of the menu bar. The information area is read-only, i.e. it can only display information and 
cannot be used to enter command lines. 


Message mx 
Arch is installed at E:/FAB_Develop/source/ arch 


Compiling architecture definition. 
Loaded 20 devices. 

Loaded 31 IP models. 

Imported 5 project instances. 
Refreshing ... 

Loaded 31 IP models. 

Vpdated 5 project instances. 
Refreshing ... 

Loaded 31 IP models. 

Vpdated 5 project instances. 


Figure 2-11 Information area of the main control window 


You can enter a character string in the € Find area, and then click ? to find information content 
forward or backward. Check Case Sensitive to match case-sensitively, otherwise it has nothing to do 
with case. 


Click the right mouse button in the information area to pop up a shortcut menu (see the figure 
below). 


Copy Ctrl4C 
Select All Ctrl1l+A 
Find... Ctrl+F 


Word Wrap 


Clear 


Figure 2-12 The shortcut menu of the information area 
о [ Copy 1: Copy the selected text to the clipboard. 


о [ SelectAll 1 : Select all information text. 
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o [ Find 1 : Search for matching information in the Message interface. 


o [ Word Wrap 1: When the window is too small to display all the information, it will automatically 
wrap and display all the information. 


o [Clear 1 : Clear all information. 


2.4 Use of Process Control 


The IP configuration process mainly includes configuring instance parameters, regenerating the 
instance, stopping regeneration, etc. These controls are located in the menu items and toolbars of the 
main control window (see the figure below), and can also be operated through shortcut menus or 
buttons in the navigation area and work area. 


а Import Instance... 


| ва Search and Import Instances... 


X Remove Instance... 


Regenerate All... 
Stop Regenerate... 


=] View Datasheet 


ра ama rema 191 нел ал 


Figure 2-13 Relevant menu items of process control 


о Е Stop Regenerate 1 : Stop regenerating IP instances, mainly for the Regenerate All operation, 
no subsequent IP instances will be regenerated, and the currently running instances will be stopped 
immediately. 


2.5 Setting Options 


Through the menu item File->Preferences, you can open an option dialog box, through which you 
can make some global settings for IP Compiler. 


The figure below shows some settings for the IP instance configuration process: 
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Preferences - Customization WR 


Synthesis 


Reserved instance name patterns (wildcard matching) 


Check the instance name vith the existing modules 


Figure 2-14 Setting configuration options 


o [ Reserved Instance Name Patterns ] : Specify the reserved IP instance name, wildcard rules 
can be used. These reserved names cannot be used in the Instance Name of the working area, 


Е А | ; : - 
otherwise а warning will be reported and the configuration cannot be performed. button Used to 


add a rule, button _— to delete the selected rule, the button D Sort all rules in ascending 


at 


alphabetical order, button Sort alphabetically in descending order. 


о | Check the instance name with the existing modules 1 : Check whether the IP instance name 
entered in the working area conflicts with the modules defined in the model, the default is not to 
check. This conflict check is protective, mainly to prevent errors when generating the top-level module 
of the IP instance ; if the IP model used is encrypted, this check may be incomplete. 


The figure below shows some settings for the synthesis tool: 


o [Synthesis Tool ] : Specify the synthesis tool to be called when generating an IP instance. The 
currently supported synthesis tools include: ADS and Synplify Pro (only IPC configured with Synplify 
Pro tool has this item), etc. If None is selected, synthesis during build is turned off. 
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Preferences - Synthesis 


Customization Synthesis Tool 405 


Temporary working directory name 


Include Path 


* 


Figure 2-15 Setting ADS synthesis tool options 


o [ Temporary working directory name ] : Specify the name of the temporary working directory 
used by the synthesis tool, which is located under the path where the IP instance is located. The default 
is rev 1. 


o [Include Path 1 : Specify the path where the synthesis tool searches for embedded HDL files. 
Multiple paths can be specified, and they will be sorted. click + To add a path, click ~ To delete the 
selected path, click ^ Move the selected path to the head of the list, click ^ Move the selected path 
up one line, click Y Move the selected path down one row, click > Move the selected paths to the end 
of the list. 
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Preferences - Synthesis Tx? 


Customization Synthesis tool Synplify Pro 


Tool path 4\pro-debug\syn\bin\synplify_pro.exe Browse... | 


Temporary working directory name rev 1| 


SHPSLMD LICENSE FILE =  270018192.29.200.21 


OK | Cancel | 
E ÍL j 


Figure 2-16 Setting up Synplify Pro Synthesis Tool Options 


о [ Tool path 1 : Specifies the execution program path of the synthesis tool Synplify Pro. 


o [ Temporary working directory name ] : Specify the name of the temporary working directory 
used by the synthesis tool. This temporary directory is located under the path where the IP instance is 
located. The default is rev 1. 


o [ SNPSLMD LICENSE FILE ] : When starting the IPC tool separately, specify the license path 
used by the synthesis tool. This setting is not reflected if the IPC is started from the PDS. 


2.6 Updates to the IP Model 


Users can obtain new IP models or upgraded versions of original IP models from IP developers. 


Click File->Update in the main window of IP Compiler to open the update dialog box, and you can 
load the IP upgrade package for viewing ( see the figure below ). Unavailable IP packages will be 
displayed in light gray. Unavailable means that they are not compatible with the current software tools, 
or are older than the currently installed IP module version. Note that unavailable does not mean that 
the IP package itself is wrong. 
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| Install Close 
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Figure 2-17 The dialog box for updating the IP model 


Clicking button [ Add packages ] will open the folder where the local IP model database is located. 


o [ Install ] : Click the button Update to start updating the checked IP module. If other existing 
IP index files are found in the installation path, a warning dialog box will pop up ( see the figure below 
), and the user can choose whether to overwrite. 


= 


Warning 1 53 Ѓ 


Found existing IP models while updating 'Cl' (version 1.01. 
А Üverwrite them with the new package? 


[yes | еа вод | № | [мо to aii]| cancel | 


Figure 2-18 Update to cover the existing IP model 


The updated IP upgrade package will be deleted from the list. Click the Close button to close the 
dialog box. At this time, it will check whether the IP instance is inconsistent with the current IP model 
version. If there is, the user will be prompted to re-associate. 


2.7 Reassociation of IP instances 


When you just start IP Compile or perform the Import operation to try to import existing IP 
instances, you may encounter situations where some instances are inconsistent with the current IP 
model version, for example, the IP model has been updated, and you need to reinstall them associated. 
It can be processed through the dialog box shown in the figure below. 
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М] Instance Маше IP Name Original Version Current Version 


м myfifo Distributed FIFO 1.1 1.2 


Figure 2-19 Reassociate IP instance 


The IP instance that needs to be processed will be listed in the table, and its original corresponding 
IP version number and current IP version number will also be indicated. The re-associated IP instance 
can be configured normally, while the operation of the unassociated IP instance is restricted, and its 
existence can only be seen in the instance list. 
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3. PARAMETER CONFIGURATION WINDOW 


The parameter configuration window of IPC is mainly used to set the parameters of a single IP 
instance. There are two pages in the working area in the middle of the window. The Configure page is 
used to configure IP parameters, and the Log page is used to display the background information of 
the generation process. The following will describe each part and function in detail. 


3.1 Parameter configuration page 


The right side of the parameter configuration page is the configuration area of IP parameters (see 
the figure below), the content of which is designed by the IP publisher and usually consists of various 
input and display controls, and there may be associations between these controls. When you move 
the mouse over a control, a prompt about the control (parameter) can be displayed (requires IP 
publisher support), click on the toolbar © button to turn this function on or off. 


Pathname р: \add\ ipcore\ LSOH\ fifo. 180 Browse... 
Instance Hame fito pd Customize 

ІР Syubol 

Наше Distributed FIFO 


Version 1.2 


wr data[3:0] full 
Vendor wr en 
Information да almost full 
wr clk => 
Part wr rst rd data[3:0] 
Family rd en enpty 
Device rd clk 


almost empty 
Package |, rd rst 
Аў 


Speed Grade 


Figure 3-1 Parameter configuration page 


For a newly opened IP instance, its initial parameter is its default value. When the user modifies 
some parameter values, it will be saved automatically before clicking the Generate button to start the 
generation process, and the user can also click the Il button to manually save the parameters, before 
closing the configuration window, if there are still modified parameter values that have not been 
saved, a prompt dialog box will pop up. click button 2 Then you can use the resource manager that 
comes with the system to open the folder where the current IP instance is located. 


On the left side of the parameter configuration page, there are some information display areas 
related to the current IP parameters. The Symbol page is used to display the icon of the I/O port, click 
the 


button to choose to show or hide the page. 


Before generating an IP instance, you can enable or disable the execution of synthesis by checking 
Enable Synthesis. Its initial state is usually set by the IPC master window or PDS. 
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With synthesis enabled, click the 52) button to view the current synthesizer parameter settings 
(see figure below). 


— 
(E Synthesis Options ES) 


set option -vlog std v2001 
set option -disable io insertion 1 


Close 


Figure 3-2 View the comprehensive options 


3.2 Background information page 


After clicking the Generate button to start the generation process, it will automatically switch to 
the Log page, and all background information will be printed to this page (see the figure below). This 
information will be automatically saved in the folder of the IP instance, and the user can also click the 
Save Log button to save the text file in other paths. 


|I Generate | B wo 


Configure | ме | 


Save Log... Find < > Case sensitive 


Run Time:00h:00m: 033 
Complete: Compile on тре synplify projrev l 

Running Flow: map (Мар) оп ipc synplify prolrev 1 

$ Mon Jun 22 14:36:15 2020 

Running: fpga mepper (Map < Optimize) on ipc, syunplify pro|rev 1 

$ Mon Jun 22 14:36:15 2020 

Copied D:Vyangrhitestiipcimyfifolrev lisymvorkimyfifo m.srm to D:\yangrh\test\ipe\eyfifto\rev_l\ay 
fpga mapper completed with warnings 

# Mon Jun 22 14:36:24 2020 

Return Code; 1 

Run Time:00h:00m:09s 

Complete: Мар on ipc synplify ргоігеу 1 

Copied D:\yangrh\test\ipe\myfifo\rev l\myfifo.srr to 0: \yangrh\resc\ipe\myfifo\rev l\ipc symplify 
Complete: Logic Synthesis on ipc synplify prolrev 1 

exit statuses 

exit stetus«0 

License checkin: synplifypro pango 

Action 'synthesize': finished normally 

Done: 0 error(s), 0 warning(s) 


Figure 3-3 background information page 
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4. CONTACTS 


Контакты для технических и коммерческих вопросов 
ООО «Инэк» 
г. Санкт-Петербург, ул. Яблочкова, д. 20, литер А, оф. 504 
contact@innek.ru 


+7 (812) 200-40-37 
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